home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / SLGetDefPrinterName.z / SLGetDefPrinterName
Text File  |  1998-10-30  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. SSSSLLLLGGGGeeeettttDDDDeeeeffffPPPPrrrriiiinnnntttteeeerrrrNNNNaaaammmmeeee((((3333))))           IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo            SSSSLLLLGGGGeeeettttDDDDeeeeffffPPPPrrrriiiinnnntttteeeerrrrNNNNaaaammmmeeee((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SLGetDefPrinterName - gets the name of the default printer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssppppoooooooollll....hhhh>>>>
  13.  
  14.      iiiinnnntttt SSSSLLLLGGGGeeeettttDDDDeeeeffffPPPPrrrriiiinnnntttteeeerrrrNNNNaaaammmmeeee((((cccchhhhaaaarrrr ********ppppnnnnaaaammmmeeeepppp))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _S_L_G_e_t_D_e_f_P_r_i_n_t_e_r_N_a_m_e returns the name of the default printer registered
  18.      with the default spooling system. The parameter _p_n_a_m_e_p is set by the
  19.      function to point to the default name string. If there is no default
  20.      printer registered with the spooling system, _p_n_a_m_e_p is set to NNNNUUUULLLLLLLL and
  21.      the function returns an error indication.
  22.  
  23. WWWWAAAARRRRNNNNIIIINNNNGGGG
  24.      Since a single static internal buffer is used by _l_i_b_s_p_o_o_l to store the
  25.      default printer name, subsequent calls to _S_L_G_e_t_D_e_f_P_r_i_n_t_e_r_N_a_m_e may change
  26.      the contents of the location pointed to by _p_n_a_m_e_p. A printer name must be
  27.      copied to a user buffer to preserve it.
  28.  
  29. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  30.      0 is returned if execution was successful. -1 is returned and _S_L_e_r_r_n_o is
  31.      set if an execution error has occurred. It is considered an error if
  32.      there is no default printer registered with the current default spooling
  33.      system.
  34.  
  35. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  36.      _S_L_G_e_t_D_e_f_P_r_i_n_t_e_r_N_a_m_e will fail under the following circumstances.
  37.  
  38.      SL_ERR_FIND_SPOOLER      An error occurred while attempting to determine
  39.                               the available printer spooling systems.
  40.  
  41.      SL_ERR_NO_SPOOLERS       There are no printer spooling systems available.
  42.  
  43.  
  44.      SL_ERR_NO_DEF_PRINTER    There is no default printer registered with the
  45.                               printer spooling system.
  46.  
  47. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  48.      SLGetPrinterList(3), SLPerror(3), libspool(3)
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.